home *** CD-ROM | disk | FTP | other *** search
/ Mac Power 1996 June / MACPOWER-1996-06.ISO.7z / MACPOWER-1996-06.ISO / AMUG / UTILITY_40 / Coffee Break 3.0.1 / Docs (plain) / Read Me next >
Text File  |  1995-12-11  |  9KB  |  191 lines
  1.                                 Coffee Break
  2.  
  3.                      Copyright 1994-95, by Thomas Reed
  4.  
  5. What it is
  6.  
  7. Coffee Break is a simple application that is designed to force you to take
  8. periodic breaks, so that you can reduce your chances of getting a Repetitive
  9. Stress Injury. You may set an amount of "work time", during which Coffee
  10. Break sits in the background with a timer displayed, and an amount of "break
  11. time", or "sleep time", during which you are forced to take a break from the
  12. computer. For more information about how to use Coffee Break, see the
  13. on-line help. (From within Coffee Break, choose Help from the File menu,
  14. Coffee Break Help from the Balloon Help menu, press the Help key (on an
  15. Extended keyboard), or press Cmd-? to access the on-line help.)
  16.  
  17. Legalities
  18.  
  19. This documentation must be included with all copies of Coffee Break. Do not
  20. give out copies of this program without the documentation. This program is
  21. available for all non-commercial use, so please feel free to pass it along
  22. to your friends. It may not be sold for profit without the author's written
  23. permission.
  24.  
  25. Shareware notice
  26.  
  27. This program is Shareware, and if you decide to keep it, you should send in
  28. a registration fee of $5, along with a brief note, which should include your
  29. e-mail address (if you have one). If you like it, please do! You'll help me
  30. put my wife through medical school! :-) You'll also ensure that I continue
  31. to write more programs, and continue to improve Coffee Break. To register,
  32. send a check or cash (in U.S. dollars) to the snail mail address at the end
  33. of this file. Thanks, and I hope you like it!
  34.  
  35. However, the real purpose behind this program is to help all you hackers and
  36. other serious typists out there keep in good health! ;-) So, if it comes
  37. down to it and you for some reason can't register it, use it anyway. Health
  38. is the prime concern here, not making money! I'm trusting you to register it
  39. if you can.
  40.  
  41. System requirements
  42.  
  43. Coffee Break requires System 7.x. It uses strictly System 7 routines for
  44. it's background/foreground switches and other things. So, there's no need to
  45. even TRY it on a machine running Sys 6. It should run on ANY machine capable
  46. of running System 7, however.
  47.  
  48. The Floating Timer option requires System 7.1 or later. If you have System
  49. 7.0.x, you will not be able to use this option.
  50.  
  51. Some of the special features depend on certain screen saver options.
  52. Different screen savers support some, all, or none of these options. Listed
  53. below is a table of which screen savers I've tested with the program and
  54. what options (from the Set Options dialog) they support. For a complete
  55. description of these options, see the on-line help.
  56.  
  57.           Saver          Pause when saver on  Built-in saver only
  58.  AfterDark 2.0x                  yes                  yes
  59.  AfterDark (pre-2.0x)            yes                   no
  60.  Basic Black 1.3.1               yes                  yes
  61.  ScreenDaemon                    yes                  yes
  62.  Sleeper                         yes                  yes
  63.  Darkside of the Mac 4.1         yes                  no*
  64.  Darkside of the Mac 4.2         yes                  yes
  65.  
  66. * note that while Darkside does not support the "Built-in saver" option, it
  67. does let you turn this option on. However, if you do, you still won't get
  68. any of the benefits of this option.
  69.  
  70. As you can tell, many screen savers DON'T support these options. I've tried
  71. nearly every screen saver I could find, and these are the only ones that are
  72. friendly enough to tell other programs of their existance. However, I've
  73. found that the ones listed above are the most widely-used screen savers.
  74.  
  75. Also, note that if you have Darkside, you should change the name of either
  76. Darkside or Coffee Break so that Coffee Break loads AFTER Darkside. If
  77. Coffee Break loads first, the screen saver options will turn themselves off,
  78. as they won't detect that a screen saver is installed. I'll undoubtedly try
  79. to compensate for this in future releases.
  80.  
  81. Introduction
  82.  
  83. This program was inspired in me several years ago (1993), when I became
  84. concerned about Repetitive Stress Injuries (RSI). Since I work with
  85. computers both at work and at home, I'm setting myself up for RSI. I didn't
  86. want that to happen, but wasn't sure what to do about it.
  87.  
  88. I heard of a shareware program that would force you to take breaks at
  89. certain intervals, but I thought that that was a kind of stupid idea.
  90. Obviously, I've discovered the usefulness of such a program by now!
  91. Unfortunately, when I actually got a copy of that program, it fell short of
  92. my expectations. So, I wrote my own, and fixed all of the problems I had
  93. with it.
  94.  
  95. A debated option
  96.  
  97. One of the options in this program, the Restrict user option, was the source
  98. of much debate between my beta testers and myself. Some felt, as I did, that
  99. the program should be heavy-handed -- to protect against our weak willpower.
  100. However, others felt that not allowing you to quit or exit a break was going
  101. a bit too far. In an attempt to satisfy both parties, this option was added.
  102. It is slightly difficult to turn off, since being able to easily do so would
  103. remove any usefulness to the former group. However, turning this option off
  104. gives the latter group the ability to quit quickly and to exit sleep mode.
  105.  
  106. As a service to registered users who feel that this feature is too much of a
  107. temptation, I will provide a version of the program with this feature
  108. disabled. If you are a registered user and would like a copy of the disabled
  109. program, you may either send me an e-mail message requesting the program, or
  110. send a self-addressed, stamped disk mailer, a blank disk, and a letter
  111. requesting the program.
  112.  
  113. Known problems
  114.  
  115. This program doesn't work well when you're playing certain games. Many games
  116. must disallow other programs from getting processor time in order to have
  117. good performance in their animations and sound effects. For such games,
  118. Coffee Break will not be able to force you to take a break until the game
  119. allows other programs to get some processor time. (This can often be during
  120. a pause or in between games.) There is nothing that I can do about this, and
  121. nothing that game authors can do unless they want to adversely affect game
  122. performance.
  123.  
  124. In addition, one game (Arashi) uses the same method to tell a program it's
  125. covering the screen as the Coffee Break-compatible screensavers listed
  126. above. In such a case, Coffee Break's timer will remain paused as long as
  127. you're playing. This is obviously a problem, but there's not much I can do
  128. to fix this.
  129.  
  130. Credits
  131.  
  132. First of all, I'd like to thank Pete Gontier for his help in installing the
  133. AfterDark Gestalts. Although I still haven't gotten them to work correctly
  134. yet (partly due to the onset of the complications of PPC code), he helped me
  135. immeasurably with understanding the underlying process.
  136.  
  137. Thanks to Keith Rollin for helping me with a few other bugs, and for his
  138. invaluable suggestions.
  139.  
  140. Thanks to John Norstad for allowing me to use snippets of his source code
  141. from NewsWatcher.
  142.  
  143. Thanks to Matt Slot for writing appe Windows, which helped immeasurably with
  144. getting Coffee Break's floating window to work.
  145.  
  146. Thanks to Craig O'Donnell for allowing me to use a sound from his Cool Mac
  147. Sounds book.
  148.  
  149. I'd also like to thank all my initial beta-testers. They not only helped me
  150. iron out many of the intermittent bugs, but they also gave me many
  151. invaluable suggestions, without which this program would not be what it is
  152. today. Thanks to Derek A. Borgford, Flint S. Hahn, Al Heynneman, Devon
  153. Hubbard, Chris Hwang, Ken Linger, Kathy Peck, Eric Thompson, Sean Vadras,
  154. and Harvey Wong. You guys were a HUGE help!
  155.  
  156. I'd like to thank the numerous people on the Internet who have, at some time
  157. or another, answered questions for me about technical problems. I'd also
  158. like to thank the people who convinced me this idea wasn't stupid. (Yes, at
  159. one point, I thought the idea of a program like this was stupid. I obviously
  160. think differently now.)
  161.  
  162. Thanks to Metrowerks for writing CodeWarrior. Thanks to Hypercard clip art
  163. for providing the basis of some of the art in the screensaver portion of the
  164. program. Thanks to whoever at Apple wrote ResEdit. (And good luck on getting
  165. a newer version out! nudge, nudge...) Thanks to Apple for making the
  166. Macintosh, without which none of this would be here.
  167.  
  168. And, most of all, thanks to all my registered users, without whom I might
  169. have stopped all this at version 1.0!
  170.  
  171. How to contact me
  172.  
  173. If you want to send me a message through e-mail, you can contact me at
  174. ThomasReed@aol.com
  175.  
  176. For registration purposes, or if you don't have access to e-mail, here's my
  177. snail mail address:
  178.  
  179. Thomas Reed
  180. 1912 McCausland
  181. St. Louis, MO 63117
  182.  
  183. WHEN YOU REGISTER, PLEASE SEND A BRIEF NOTE TO TELL ME WHAT YOUR E-MAIL
  184. ADDRESS IS, IF YOU HAVE ONE.
  185.  
  186. Hope you like Coffee Break!
  187.  
  188. Also look for my games! Try Valley of Peril, if you're into adventure games!
  189. It's freeware, so there's no charge! Also try The Solitaire of Champions if
  190. you like solitaire games.
  191.